home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_hylafax.idb / usr / freeware / man / cat4 / destctrls.Z / destctrls
Encoding:
Text File  |  1999-07-16  |  5.3 KB  |  130 lines
  1.  
  2.  
  3.  
  4. DDDDEEEESSSSTTTTCCCCTTTTRRRRLLLLSSSS((((4444FFFF))))    UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOccccttttoooobbbbeeeerrrr 3333,,,, 1111999999995555))))    DDDDEEEESSSSTTTTCCCCTTTTRRRRLLLLSSSS((((4444FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      destctrls - per-destination controls for _H_y_l_a_F_A_X servers
  10.  
  11. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.      The _H_y_l_a_F_A_X configuration parameter DDDDeeeessssttttCCCCoooonnnnttttrrrroooollllssss specifies
  13.      whether or not to apply per-destination controls on job
  14.      characteristics such as the time-of-day to place a call.
  15.  
  16.      The controls file is a simple ASCII file containing a series
  17.      of records of the form:
  18.           _d_e_s_t    param = value ... param = value
  19.      where _d_e_s_t is a regular expression matched against the
  20.      canonical form of a destination phone number and parameters
  21.      are specified by named assignments (though the ``='' can
  22.      also be left out).  Whitespace may be used freely though it
  23.      is used to identify the end of _d_e_s_t and the start of the
  24.      parameter list.  Parameter values are parsed exactly as
  25.      specified in _c_o_n_f_i_g(4F); i.e. values with embedded
  26.      whitespace may be enclosed in quote marks (``"'').
  27.  
  28.      Comments are introduced with a ``#'' character and extend to
  29.      the end of the line.  Parameter lists may be continued
  30.      across lines by starting subsequent lines with a whitespace
  31.      character (lines commented out with ``#'' are also
  32.      considered to be part of a continued record).
  33.  
  34.      The order of entries in a file is important.  When a
  35.      parameter value is needed _f_a_x_q sequentially scans the file
  36.      until it finds a record that matches the canonical form of
  37.      the destination phone number.  If the requested parameter is
  38.      defined in this record, then the value is returned,
  39.      otherwise a default value is used from the _f_a_x_q
  40.      configuration file.
  41.  
  42.      The following parameters may be specified on a per-
  43.      destination basis; consult _c_o_n_f_i_g(4F) for a description of
  44.      each parameter (except RRRReeeejjjjeeeeccccttttNNNNoooottttiiiicccceeee which is described
  45.      below).
  46.      TTTTaaaagggg                  TTTTyyyyppppeeee       DDDDeeeeffffaaaauuuulllltttt      DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  47.      MaxConcurrentJobs    integer    1            max concurrent jobs to process for a destination
  48.      MaxDials             integer    _u_n_l_i_m_i_t_e_d    max phone calls to make to transmit a job
  49.      MaxSendPages         integer    _u_n_l_i_m_i_t_e_d    max pages to permit in a send
  50.      MaxTries             integer    3            max attempts to transmit a job
  51.      RejectNotice         string     -            rejection notice for transmit job
  52.      TimeOfDay            string     Any          default time-of-day restrictions
  53.  
  54.      The RRRReeeejjjjeeeeccccttttNNNNoooottttiiiicccceeee parameter controls whether or not to reject
  55.      jobs to the destination.  Jobs that are rejected are done so
  56.      without placing a phone call and the associated message is
  57.      returned to the job submitter.  This facility can be used to
  58.      disallow calling sensitive phone numbers; for example
  59.  
  60.  
  61. Page 1                                          (printed 6/24/99)
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68. DDDDEEEESSSSTTTTCCCCTTTTRRRRLLLLSSSS((((4444FFFF))))    UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOccccttttoooobbbbeeeerrrr 3333,,,, 1111999999995555))))    DDDDEEEESSSSTTTTCCCCTTTTRRRRLLLLSSSS((((4444FFFF))))
  69.  
  70.  
  71.  
  72.       .*911$    RejectNotice = "Calls to emergency numbers are not permitted"
  73.  
  74.      In addition to the above parameters, any other parameters
  75.      that are specified are automatically accumulated and passed
  76.      to programs invoked by _f_a_x_q, such as _f_a_x_s_e_n_d and _p_a_g_e_s_e_n_d.
  77.      This is a convenient mechanism for defining configuration
  78.      parameters for all modems without having to modify each
  79.      modem-specific configuration file.  For example,
  80.       .*    SessionTracing = 0x4f
  81.  
  82.      This mechanism also makes it easy to control transmit-
  83.      related parameters according to the destination phone
  84.      number.  For example, to disable use of ECM and restrict the
  85.      transmit speed when placing international phone calls one
  86.      might use:
  87.       [+][^1]    DesiredBR=9600 DesiredEC=false
  88.  
  89. NNNNOOOOTTTTEEEESSSS
  90.      Beware that canonical phone numbers have a leading ``+''
  91.      which is a special character for regular expressions.  An
  92.      easy way to match ``+'' is with ``[+]''; e.g.
  93.      ``[+]14159657824''.
  94.  
  95. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  96.      _f_a_x_q(1M), _c_o_n_f_i_g(4F), _r_e__f_o_r_m_a_t(7).
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126. Page 2                                          (printed 6/24/99)
  127.  
  128.  
  129.  
  130.